9. Supplementary Service Commands > 9.12 AT+CPUC   Price per unit and currency table

9.12
AT+CPUC   Price per unit and currency table
Syntax
Test Command  
Response(s)
Read Command  
Response(s)
Write Command  
Response(s)
Reference(s) 
PIN 
ASC0 
ASC1 
USB 
MUX1 
MUX2 
MUX3 
Charge 
Last 
GSM 07.07

Command Description
Read command returns the current parameters of PUC.
Write command sets the parameters of Advice of Charge related price per unit and currency table. SIM PIN2 is usually required to set the parameters.

Parameter Description
 
<currency>(str)(+CSCS)
Three-character currency code (e.g. "GBP", "EUR"). If the currency name is longer than three characters, all characters will be cut off after the third position. Before they are written to the SIM Card, these characters are converted to the standard GSM alphabet.
 
<ppu>(str)
Price per unit; dot is used as a decimal separator (e.g. "2.66"). The length is limited to 20 characters. If the string length is exceeded, the command is terminated with an error. This string may only contain digits and a dot. LeadĀ­ing zeros are removed from the string. The minimum and maximum value are determined by the structure of the SIM-PUCT file. The maximum price per unit value is 999 999 999.00. When successfully entered, this value is rounded to maximum accuracy.
Note: Due to storage in mantisse (range 0-4095) and exponent (-7 to 7) it is possible that rounding errors occur.
 
SIM PIN2. String parameter which can contain any combination of characters. The maximum string length is limited to 8 characters. If this value is exceeded, the command terminates with an error message. If the PIN2 is incorrect, a CME error (+CME ERROR: incorrect password) is output.


Example

To change currency and/or price per unit you have two ways:

You can enter PIN2 along with the AT+CPUC command:
 
Alternatively, you can first use the AT+CPIN2 command to enter PIN2. When you execute the AT+CPUC comĀ­mand, subsequently, take into account that PIN2 authentication expires after 300ms (see notes in AT+CPIN2).